@lingui/core

What is @lingui/core?

@lingui/core is a library for internationalization (i18n) in JavaScript applications. It provides tools for managing translations, formatting messages, and handling locale data. It is designed to be flexible and easy to integrate with various frameworks and libraries.

What are @lingui/core's main functionalities?

Message Formatting

This feature allows you to format messages with placeholders that can be replaced with dynamic values. The example demonstrates loading a translation, activating a locale, and formatting a message with a dynamic name.

const { i18n } = require('@lingui/core');
const { setupI18n } = require('@lingui/core');

const i18n = setupI18n();
i18n.load({
  en: {
    message: 'Hello, {name}!'
  }
});
i18n.activate('en');

const message = i18n._('message', { name: 'John' });
console.log(message); // Output: Hello, John!

Locale Management

This feature allows you to manage different locales and switch between them. The example shows how to load translations for multiple locales and activate a specific locale to get the translated message.

const { i18n } = require('@lingui/core');
const { setupI18n } = require('@lingui/core');

const i18n = setupI18n();
i18n.load({
  en: { message: 'Hello' },
  fr: { message: 'Bonjour' }
});
i18n.activate('fr');

const message = i18n._('message');
console.log(message); // Output: Bonjour

Custom Pluralization Rules

This feature allows you to define custom pluralization rules for different languages. The example demonstrates how to use pluralization in a message based on the count value.

const { i18n } = require('@lingui/core');
const { setupI18n } = require('@lingui/core');

const i18n = setupI18n();
i18n.load({
  en: {
    message: '{count, plural, one {# item} other {# items}}'
  }
});
i18n.activate('en');

const message = i18n._('message', { count: 5 });
console.log(message); // Output: 5 items

Other packages similar to @lingui/core

i18next

i18next is a popular internationalization framework for JavaScript. It provides similar functionalities to @lingui/core, such as message formatting, locale management, and pluralization. However, i18next has a larger ecosystem with more plugins and integrations available.

react-intl

react-intl is a library specifically designed for internationalization in React applications. It offers similar features to @lingui/core, such as message formatting and locale management, but is tightly integrated with React components and hooks.

globalize

Globalize is a library for internationalization and localization in JavaScript. It provides functionalities for formatting numbers, dates, and messages, similar to @lingui/core. Globalize is built on top of the Unicode CLDR data and focuses on providing comprehensive localization support.

README

@lingui/core

Internationalization API for JavaScript apps

@lingui/core is part of LinguiJS. See the documentation for all information, tutorials and examples.

Installation

npm install --save @lingui/core
# yarn add @lingui/core

Usage

See the tutorial or reference documentation.

License

This package is licensed under MIT license.

Changelog

3.17.2 (2023-02-24)

Bug Fixes

• vite: externalize macro imports (#1466) (1719430)
• vite-plugin: change default export to named export (#1465) (15510c1), closes #1450
• vite-plugin: ship in dual package format for compatibility with Vite (#1450) (e3a2b39)
• chain extract on watched file changes (#1435) (5dd50d3)
• param name for missing in setupI18nProps (#1411) (6459f02)
• cli: fix version command (#1413) (8bc212d)